home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 36 / dvscode.zip / DVSCODE.DOC < prev   
Text File  |  1987-11-08  |  11KB  |  225 lines
  1.  
  2.  
  3.                                DVSCODE
  4.                   Desqview Extended Scan Code Reference
  5.                     (c) Daniel T. Travison Jr., 1987
  6.  
  7.                          GEnie Email: D.TRAVISON
  8.  
  9.                   Hotel Henge 518-399-3073 (10pm-10am)
  10.  
  11.                           Non-Electronic Mail:
  12.                               P.O. Box 165
  13.                          Burnt Hills, NY  12027
  14.  
  15.       DVSCODE is an extended scan code reference for Quarterdeck's Desqview
  16.       version 2.0. It is designed to provide the same information as is
  17.       found in the Basic 3.0 reference manual for the extended scan codes.
  18.       Since I refer to that page quite frequently I decided to put together
  19.       this program for easier reference.  Those of you that have tried
  20.       DVASCII.COM may notice a similarity.  This program was created using
  21.       the same source code with only a few modifications to account for the
  22.       different screens.
  23.  
  24.  
  25.       You are granted permission to distribute this program with the
  26.       stipulation that NO remittance is accepted for either the program
  27.       or handling and distribution charges.  This program may not be
  28.       distributed with other programs on disk if a charge is incurred
  29.       for any program or for the medium.  In other words, if there is
  30.       a charge involved then you do not have permission to include this
  31.       program, period!
  32.  
  33.   ╒══════════════════════════════════════════════════════════════════════════╕
  34.   │ The author makes no warranties expressed or implied as to the quality or │
  35.   │ performance of this program.  The author will not be held liable for any │
  36.   │ direct, indirect,  incidental or consequential  damages  resulting  from │
  37.   │ the use of this program.   Your use of  this  program  constitutes  your │
  38.   │ agreement to this disclaimer and your releasing the author from any form │
  39.   │ of liability or litigation.                                              │
  40.   ╘══════════════════════════════════════════════════════════════════════════╛
  41.  
  42.  
  43.  
  44.       I put this little program together recently while working on a
  45.       another unrelated project.  I found myself constantly refering
  46.       to the reference provided in the Basic 3.0 manual and felt that
  47.       I had a perfect candidate for a small quick reference to run in
  48.       Desqview.  
  49.       
  50.       The information following is the same as found in the documentation 
  51.       for DVASCII.COM with minor modifications for account for the 
  52.       differences between DVASCII.COM and DVSCODE.COM.
  53.  
  54.       Desqview routines used:
  55.  
  56.          1: Checks for the presence of Desqview and exits with an error
  57.             if Desqview is not found.
  58.  
  59.          2: The program writes directly to the screen buffer provided by
  60.             Desqview.
  61.  
  62.          3: The program releases the rest of the time slice when ever it
  63.             finishes a screen and also after determining that no
  64.             key has been pressed.
  65.  
  66.       Most of the speed is derived from the fact that each screen is hard
  67.       coded in memory and simply copied to the buffer provided by Desqview.
  68.       The extra memory required for this is offset by the memory saved by
  69.       restricting the screen size in the setup.  The program only uses
  70.       an area 18 rows by 24 columns.  You will notice the setup has the
  71.       maximum size set to these values as well.  Desqview allocates 864
  72.       bytes for the screen buffer as opposed to 4000 bytes for a full
  73.       screen buffer.  The program itself runs in a 4k window. Total memory
  74.       to run the program totals 9k.  This includes the screen buffer as well
  75.       as memory needed for shell.com and other Desqview features.
  76.  
  77.       Another benefit of this method is that all the code normally included
  78.       for determining the Video mode and the refresh logic is eliminated.
  79.       This proved a major benefit since I have just started to learn assembler
  80.       and have enough to worry about.
  81.  
  82.       Requirements:
  83.  
  84.          Desqview 2.0  :You MUST have this version or later
  85.  
  86.          Dvscode.com   :the executable program
  87.  
  88.          Co-pif.dvp    :the program information file used by desqview
  89.                         (see next section)
  90.  
  91.          Reasonable compatability with the 'standard' IBM is assumed when
  92.          running this program.  I use interupt 16h to check for key
  93.          strokes pending and to retrieve the same.
  94.  
  95.  
  96.  
  97.       Program information file: 
  98.       
  99.          I have provided the 2 screens from change a program to illustrate the
  100.          required settings should the At-pif.dvp be missing or incorrect.
  101.          Five points should be noted:
  102.  
  103.             1: Memory size is set to 4k. More is not needed, less will
  104.                produce an error message.
  105.  
  106.             2: Maximum and starting screen size is set to 17 for the height
  107.                and 43 for the width.  Increasing values will distort the
  108.                display.  Decreasing these values can cause serious problems
  109.                when the program tries to write to memory that is not
  110.                allocated to it.
  111.  
  112.             3: All memory options on the Advanced screen are set to zero.
  113.                changing this will only allocate memory to the program
  114.                that will not be used and is therefore wasted.
  115.  
  116.             4: The close on exit to DOS option is set to yes.  This
  117.                allows Desqview to use its own shell.com instead of
  118.                command.com to load the program.  The saves a nice
  119.                chunk of memory that would otherwise be wasted.
  120.  
  121.             5: The program will appear on the Add a program (other)
  122.                menu as Desqview Scan Code.  Keep this in mind in case
  123.                you have a problem finding it.
  124.  
  125.  
  126.  
  127.  
  128. ┌─────────────────────────────────────────────────────────────────────────────┐
  129. │                              Change a Program                               │
  130. │                                                                             │
  131. │Program Name............: Desqview Scan Code                                 │
  132. │                                                                             │
  133. │Keys to Use on Open Menu: CO                         Memory Size (in K):   4 │
  134. │─────────────────────────────────────────────────────────────────────────────│
  135. │Program...: DVSCODE.COM                                                      │
  136. │                                                                             │
  137. │Parameters:                                                                  │
  138. │                                                                             │
  139. │Directory.: C:\UTILITY\GENERAL                                               │
  140. │─────────────────────────────────────────────────────────────────────────────│
  141. │Options:                                                                     │
  142. │                    Writes directly to screen......: [N]                     │
  143. │                    Displays graphics information..: [N]                     │
  144. │                    Can be swapped out of memory...: [Y]                     │
  145. │                    Requires floppy diskette.......: [N]                     │
  146. │                                                                             │
  147. │  Press F1 for advanced options                  Press ─┘ when you are DONE  │
  148. └─────────────────────────────────────────────────────────────────────────────┘
  149.  
  150.  
  151.  
  152. ┌─────────────────────────────────────────────────────────────────────────────┐
  153. │                     Change a Program Advanced Options                       │
  154. │                                                                             │
  155. │System Memory (in K).......:   0   Maximum Program Memory Size (in K)..:     │
  156. │                                                                             │
  157. │Script Buffer Size.......:     0   Maximum Expanded Memory Size (in K):      │
  158. │                                                                             │
  159. │Text Pages: 1  Graphics Pages: 0   Initial Mode:        Interrupts: 00 to FF │
  160. │─────────────────────────────────────────────────────────────────────────────│
  161. │Window Position:                                                             │
  162. │   Maximum Height:  17       Starting Height:  17       Starting Row...:   1 │
  163. │   Maximum Width.:  43       Starting Width.:  43       Starting Column:   1 │
  164. │─────────────────────────────────────────────────────────────────────────────│
  165. │                               Shared Program                                │
  166. │Pathname..:                                                                  │
  167. │                                                                             │
  168. │Data......:                                                                  │
  169. │─────────────────────────────────────────────────────────────────────────────│
  170. │Options:                                                                     │
  171. │   Close on exit to DOS.........: [Y]      Uses its own colors.........: [N] │
  172. │   Allow Close Window command...: [Y]      Runs only in foreground.....: [Y] │
  173. │   Uses math coprocessor........: [N]      Keyboard conflict (0-4).....: [0] │
  174. │                                                                             │
  175. │ Press F1 for standard options                  Press ─┘ when you are DONE   │
  176. └─────────────────────────────────────────────────────────────────────────────┘
  177.  
  178.  
  179.       Display Control:
  180.  
  181.          Three keys are used to control the program function.
  182.  
  183.          ** 1: Page Down: Displays the next page of the Reference
  184.  
  185.          ** 2: Page Up: Displays the previous page of the Reference.
  186.  
  187.             3: Escape: Exits the program.  Close the window when
  188.                the 'Close on exit to DOS' option is set to Y.
  189.  
  190.          ** NOTE:  Paging is circular in that paging down when on the
  191.             last chart page returns to the first page. Paging up when
  192.             on the first display page will move to the last page.
  193.  
  194.       Compatability:
  195.  
  196.             This program has been successfully run on the following
  197.             three machines:
  198.  
  199.                1: Compaq 386   (color)
  200.  
  201.                2: IBM 8mhz AT  (monochrome graphics)
  202.  
  203.                3: My 8mhz XT.  (color)  This machine is an example 
  204.                   of the extreme in that the parts were purchased 
  205.                   from at least 7 different manufactures, none of
  206.                   which are known for their large market share.
  207.                   The CPU is a NEC V20 and the BIOS is by PHEONIX
  208.                   (version 2.26)
  209.  
  210.       The End:
  211.  
  212.          I have written this program because I have not found a
  213.          satisfactory alternative.  I have learned a little about
  214.          assmebler along the way and consider that sufficient
  215.          compensation for the time and effort spent on this
  216.          program.  I do have an EGO so feel free to send comments
  217.          using one of the methods provided above.  Users that are
  218.          in the same stages of learning assembler as myself may
  219.          have a copy of the source as an example of actual uses
  220.          for the routines Quarterdeck provides.  Experienced
  221.          assembler programmer's will be bored and only point out
  222.          all the different areas where my ignorance of assembler.
  223.  
  224.  
  225.